Commands

---

This chapter contains information on the following Command functions:

Introduction to File Transfer via TFTP or HTTP: Describes the available file transfer methods.
Update AP: Download files via TFTP or HTTP to the AP.
Retrieve File: Upload configuration files from the AP to a TFTP server.
Reboot: Reboot the AP in the specified number of seconds.
Reset: Reset all of the Access Point's configuration settings to factory defaults.
Help Link: Configure the location where the AP Help files can be found.

To perform commands using the HTTP/HTTPS interface, you must first log in to a web browser. See Related Topics for instructions.

You may also perform commands using the command line interface. See Command Line Interface (CLI) for more information.

To perform commands via HTTP/HTTPS:

Click the Commands button located on the left-hand side of the screen.





Figure 6-1 Commands Main Screen
Click the tab that corresponds to the command you want to issue. For example, click Reboot to restart the unit.

Following a brief introduction to TFTP and HTTP file transfer, each Commands tab is described in the remainder of this chapter.

Introduction to File Transfer via TFTP or HTTP

There are two methods of transferring files to or from the AP: TFTP or HTTP (or HTTPS if enabled):

Downloading files (Configuration, AP Image, Bootloader, License, Private Key, Certificate, CLI Batch File) to the AP using one of these two methods is called "Updating the AP."
Uploading files (Configuration, CLI Batch File) from the AP is called "Retrieving Files."

TFTP File Transfer Guidelines

A TFTP server must be running and configured to point to the directory containing the file.

If you do not have a TFTP server installed on your system, install the TFTP server from the ORiNOCO CD.

HTTP File Transfer Guidelines

HTTP file transfer can be performed either with or without SSL enabled.

HTTP file transfers with SSL require enabling Secure Management and Secure Socket Layer. HTTP transfers that use SSL may take additional time.

NOTE: SSL requires Internet Explorer version 6, 128 bit encryption, Service Pack 1, and patch Q323308.

Image Error Checking During File Transfer

The Access Point performs checks to verify that an image downloaded through HTTP or TFTP is valid. The following checks are performed on the downloaded image:

Zero Image size
Large image size
Non VxWorks image
AP image
Digital signature verification

If any of the above checks fail on the downloaded image, the Access Point deletes the downloaded image and retains the old image. Otherwise, if all checks pass successfully, the AP deletes the old image and retains the downloaded image.

These checks are to ensure that the AP does not enter an invalid image state. The storage of the two images is only temporary to ensure the proper verification; the two images will not be stored in the AP permanently.

Image error checking functions automatically in the background. No user configuration is required.

Update AP

Update AP via TFTP

Use the Update AP via TFTP tab to download Configuration, AP Image, License file, Bootloader files, Certificate and Private Key files, and CLI Batch File to the AP. A TFTP server must be running and configured to point to the directory containing the file.

Figure 6-2 Update AP via TFTP Command Screen

If you do not have a TFTP server installed on your system, install the TFTP server from the ORiNOCO CD. You can either install the TFTP server from the CD Wizard or run OEM-TFTP-Server.exe found in the CD's Xtras/SolarWinds sub-directory.

The Update AP via TFTP tab shows version information and allows you to enter TFTP information as described below.

Server IP Address: Enter the TFTP server IP Address.
Double-click the TFTP server icon on your desktop and locate the IP address assigned to the TFTP server.
NOTE: This is the IP address that will be used to point the Access Point to the AP Image file.
File Name: Enter the name of the file to be downloaded (including the file extension).
Copy the file to the TFTP server's root folder. The default AP Image is located at C:/Program Files/ORiNOCO/AP4x00/.
File Type: Select the proper file type. Choices include:
Config: configuration information, such as System Name, Contact Name, and so on.
Image: AP Image (executable program).
Upgrade BspBl: Bootloader software.
License File: the license key to allow conversion of an AP-4000 unit to an AP-4000M unit.
SSL Certificate: the digital certificate for authentication in SSL communications.
SSL Private Key: the private key for encryption in SSL communications.
SSH Public Key: the public key in SSH communications. See Secure Shell (SSH) Settings for more information.
SSH Private Key: the private key in SSH communications. See Secure Shell (SSH) Settings for more information.
CLI Batch File: a CLI Batch file that contains CLI commands to configure the AP. This file will be executed by the AP immediately after being uploaded. See CLI Batch File for more information.
File Operation: Select either Update AP or Update AP & Reboot. You should reboot the AP after downloading files.

Update AP via HTTP

Use the Update AP via HTTP tab to download Configuration, AP Image, Bootloader files, and Certificate and Private Key files to the AP.

Once on the Update AP screen, click on the via HTTP tab.

Figure 6-3 Update AP via HTTP Command Screen

The Update AP via HTTP tab shows version information and allows you to enter HTTP information as described below.

Select the File Type that needs to be updated from the drop-down box. Choices include:
Image for the AP Image (executable program).
Config for configuration information, such as System Name, Contact Name, and so on.
SSL Certificate: the digital certificate for authentication in SSL communications.
SSL Private Key: the private key for encryption in SSL communications.
Upgrade BSPBL: the Bootloader software.
CLI Batch File: a CLI Batch file that contains CLI commands to configure the AP. This file will be executed by the AP immediately after being uploaded. See CLI Batch File for more information.
SSH Public Key: the public key in SSH communications. See Secure Shell (SSH) Settings for more information.
SSH Private Key: the private key in SSH communications. See Secure Shell (SSH) Settings for more information.
License File: the license key to allow conversion of an AP-4000 unit to an AP-4000M unit.
Use the Browse button or manually type in the name of the file to be downloaded (including the file extension) in the File Name field. If typing the file name, you must include the full path and the file extension in the file name text box.
To initiate the HTTP Update operation, click the Update AP button.

A warning message gets displayed that advises the user that a reboot of the device will be required for changes to take effect.





Figure 6-4 Warning Message
Click OK to continue with the operation or Cancel to abort the operation.
NOTE: An HTTP file transfer using SSL may take extra time.

If the operation completes successfully the following screen appears.





Figure 6-5 Update AP Successful

If the operation did not complete successfully the following screen appears, and the reason for the failure is displayed.

Figure 6-6 Update AP Unsuccessful

Retrieve File

Retrieve File via TFTP

Use the Retrieve File via TFTP tab to upload files from the AP to the TFTP server. The TFTP server must be running and configured to point to the directory to which you want to copy the uploaded file. We suggest you assign the file a meaningful name, which may include version or location information.

If you don't have a TFTP server installed on your system, install the TFTP server from the ORiNOCO CD. You can either install the TFTP server from the CD Wizard or run OEM-TFTP-Server.exe found in the CD's Xtras/SolarWinds sub-directory.

The Retrieve AP via TFTP tab shows version information and allows you to enter TFTP information as described below.

Server IP Address: Enter the TFTP server IP Address.
Double-click the TFTP server icon on your desktop and locate the IP address assigned to the TFTP server.
File Name: Enter the name of the file to be uploaded.
File Type: Select the type of file to be uploaded: Config file, CLI Batch File, or CLI Batch (Error) Log.

Use the following procedure to retrieve a file from an AP to a TFTP server:

If retrieving a Config file, configure all the required parameters in their respective tabs. Reboot the device.
Retrieve and store the file. Click the Retrieve File button to initiate the upload of the file from the AP to the TFTP server.
If you retrieved a Configuration file, update the file as necessary.
If you retrieved a CLI Batch File or CLI Batch Log, you can examine the file using a standard text editor. For more information on CLI Batch Files, see CLI Batch File.





Figure 6-7 Retrieve File via TFTP Command Screen

Retrieve File via HTTP

Use the Retrieve File via HTTP tab to retrieve configuration files, CLI Batch Files, or CLI Batch Logs from the AP. Select the type of file (Config, CLI Batch File, or CLI Batch Log) from the File Type drop-down menu.

For more information on CLI Batch Files and CLI Batch Logs see CLI Batch File.

Click on the Retrieve File button to initiate the operation.

Figure 6-8 Retrieve File via HTTP Command Screen

A confirmation message is displayed, asking if the user wants to proceed with retrieving the file.

Figure 6-9 Retrieve File Confirmation Dialog

Click OK to continue with the operation or Cancel to abort the operation. On clicking OK, the File Download window appears.

Figure 6-10 File Download Dialog Box

On clicking the Save button the Save As window displays, where the user is prompted to choose the filename and location where the file is to be downloaded. Select an appropriate filename and location and click OK.

Reboot

Use the Reboot tab to save configuration changes (if any) and reset the AP. Enter a value between 0 and 65535 seconds; entering a value of 0 (zero) seconds causes an immediate reboot. Note that Reset, described below, does not save configuration changes.

CAUTION: Rebooting the AP will cause all users who are currently connected to lose their connection to the network until the AP has completed the restart process and resumed operation.

Figure 6-11 Reboot Command Screen

Reset

Use the Reset tab to restore the AP to factory default conditions. Since this will reset the AP's current IP address, a new IP address must be assigned. See Recovery Procedures for more information.

CAUTION: Resetting the AP to its factory default configuration will permanently overwrite all changes that have made to the unit. The AP will reboot automatically after this command has been issued.

Figure 6-12 Reset to Factory Defaults Command Screen

NOTE: The AP may also be reset from the RESET button located on the side of the unit. However, this action will not reset the unit to factory default settings.

Help Link

Use the Help tab to configure the location of the AP Help files.

During initialization, the AP on-line help files are downloaded to the default location: C:/Program Files/ORiNOCO/AP4xxxx/HTML/index.htm.

To enable the Help button on each page of the Web interface to access the help files, however, copy the entire Help folder to a web server, then specify the new HTTP path in the Help Link box.

NOTE: The configured Help Link must point to an HTTP address in order to enable the Help button on each page of the Web interface.

NOTE: Use the forward slash character ("/") rather than the backslash character ("\") when configuring the Help Link location.

NOTE: Add the AP's management IP address into the Internet Explorer list of Trusted Sites.

Figure 6-13 Help Link Configuration Screen